home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / lib / tex / inputs / cite.sty < prev    next >
Encoding:
Text File  |  1991-05-21  |  3.8 KB  |  96 lines
  1. %     CITE.STY -- compress numerical citations.
  2. %     See also OVERCITE.STY.
  3. %
  4. %     Copyright (C) 1989,1990 by Donald Arseneau
  5. %     These macros may be freely transmitted, reproduced, or modified for
  6. %     non-commercial purposes provided that this notice is left intact.
  7. %     
  8. %     Instructions follow \endinput.
  9. %  ------------------------------------
  10. %
  11. %  Pull out the code that writes the aux file citation and formats 
  12. %  the number.  \citen can be used by itself to give citation numbers 
  13. %  without the other formatting; e.g., "See also ref.~\citen{junk}."
  14. %
  15. \def\citen#1{%
  16. \if@filesw \immediate \write \@auxout {\string \citation {#1}}\fi 
  17. \@tempcntb\m@ne \let\@h@ld\relax \def\@citea{}%
  18. \@for \@citeb:=#1\do {%
  19.   \@ifundefined {b@\@citeb}%
  20.     {\@h@ld\@citea\@tempcntb\m@ne{\bf ?}%
  21.     \@warning {Citation `\@citeb ' on page \thepage \space undefined}}%
  22. % else, defined
  23.     {\@tempcnta\@tempcntb \advance\@tempcnta\@ne
  24.     \setbox\z@\hbox\bgroup % check if citation is a number:
  25.     \ifnum0<0\csname b@\@citeb \endcsname \relax
  26.        \egroup \@tempcntb\number\csname b@\@citeb \endcsname \relax
  27.        \else \egroup \@tempcntb\m@ne \fi
  28.     \ifnum\@tempcnta=\@tempcntb % Number follows previous--hold on to it
  29.        \ifx\@h@ld\relax % first pair of successives
  30.           \edef \@h@ld{\@citea\csname b@\@citeb\endcsname}% 
  31.        \else % compressible list of successives
  32. %         % use \hbox to avoid easy \exhyphenpenalty breaks 
  33.           \edef\@h@ld{\hbox{--}\penalty\@highpenalty
  34.             \csname b@\@citeb\endcsname}%
  35.        \fi
  36.     \else   %  non-successor--dump what's held and do this one
  37.        \@h@ld\@citea\csname b@\@citeb \endcsname 
  38.        \let\@h@ld\relax
  39.     \fi}%
  40. %%    To put space after the comma, use:
  41.  \def\@citea{,\penalty\@highpenalty\hskip.13em plus.1em minus.1em}%
  42. %%    For no space after comma, use:
  43. %% \def\@citea{,\penalty\@highpenalty}% 
  44. %%
  45. }\@h@ld}
  46. % 
  47. %     Replacement for \@citex:
  48. % 
  49. \def\@citex[#1]#2{\@cite{\citen{#2}}{#1}}%
  50. %
  51. %  Replacement for \@cite 
  52. %
  53. \def\@cite#1#2{\leavevmode\unskip
  54.   \ifnum\lastpenalty=\z@\penalty\@highpenalty\fi% highpenalty before
  55.   \ [{\multiply\@highpenalty 3 #1%             % triple-highpenalties within
  56.       \if@tempswa,\penalty\@highpenalty\ #2\fi % and before note.
  57.     }]\spacefactor\@m}
  58. %
  59. \endinput
  60. %
  61. %     
  62. %                          CITE.STY
  63. %
  64. %     Modify LaTeX's normal citation mechanism to:
  65. %
  66. %     o Allow, but strongly discourage, line breaks within a series of
  67. %       citations.  Each number is separated by a comma and a small space.
  68. %       A break at the beginning of an optional note is discouraged also.
  69. %
  70. %     o Compress lists of three or more consecutive numbers to one number 
  71. %       range which can be split, with difficulty, after the dash.  No sorting
  72. %       to optimize compression is done.  All numbers should be greater than
  73. %       zero. E.g., if you used to get [5,6,7,9,8,Einstein,6], then this style 
  74. %       will give you [5--7,9,8,Einstein,6]. 
  75. %
  76. %     o Always puts an interword space before the citation and allow a 
  77. %       highpenalty break there (unless you specifically forbid it with ~).
  78. %       E.g.,   Something really stupid \cite{Larry,Curly,Moe}.
  79. %                                      ^-- This space doesn't matter.
  80. %
  81. %     To get just the numbers (and write to the aux file) without the
  82. %     extra formatting, use \citen just like \cite.
  83. %
  84. %     Linebreaks are allowed with triple-highpenalties after dashes
  85. %     and commas; these may have to be taken if TeX sees no other 
  86. %     viable breakpoints.  If you think citations are being split 
  87. %     unnecessarily, try using \sloppy or a sloppypar environment.
  88. %
  89. %     FRAGILE!
  90. %
  91. % Send problem reports to asnd@triumfcl.bitnet or Arseneau@mtsg.ubc.ca
  92. %
  93. % test integrity:
  94. % brackets: round, square, curly, angle:   () [] {} <>
  95. % backslash, slash, vertical, hat, tilde:   \ / | ^ ~
  96.